Aviation API
12 MSL Analysis Charts
The mean sea level (MSL) charts are drawn by forecasters 4 times a day. The analysis is the forecaster analysis of the current situation.
12.1 Latest Analysis for a Location
Request the latest analysis chart for the specified region. At this time the only region accepted is nz-au (New Zealand and Australia area).
12.1.1 API Call:
GET /aviation/chart/msl/analysis/{region}/latest
12.1.2 Path Parameter:
Path Parameter | Example | Description |
---|---|---|
region | nz-au | A supported region code. The region code must be lowercase. This parameter is Mandatory. |
12.1.3 Example:
This example would return the latest MSL analysis chart for the NZ and Australia region.
GET /aviation/chart/msl/analysis/nz-au/latest
12.1.4 API Response:
{
"version": "1.0",
"issue-time": "2025-09-08T22:35:45Z",
"path": "/aviation/api/aviation/chart/msl/analysis/nz-au/latest",
"response": [
{
"met:locator": "https://api.metservice.com/aviation/assets/chart/msl/nz-au/anal/2025/09/08/18/202509081800_202509081800_202509081950.gif",
"met:analysis-time": "2025-09-08T18:00:00Z",
"met:product-name": "msl",
"met:domain": "aviation",
"met:issue-time": "2025-09-08T19:50:00Z",
"av:chart-type": "msl",
"met:prognosis-period": "000",
"av:msl-region": "nz-au",
"met:valid-at": "2025-09-08T18:00:00Z",
"av:msl-type": "analysis",
"met:validity": "18"
}
]
}
12.2 Analysis for a Location at a specific validity
Request the latest analysis chart for the specified region and validity.
12.2.1 API Call:
GET /aviation/chart/msl/analysis/{region}/{validity}
12.2.2 Path Parameters:
Path Parameter | Example | Description |
---|---|---|
region | nz-au | A supported region code. The region code must be lowercase. This parameter is Mandatory. |
validity | 06 | The validity of the chart. The validity is one of: 00, 06, 12, 18. This parameter is Mandatory. |
12.2.3 Example:
This example would return the MSL analysis chart for the NZ and Australia region with a validity as specified in the API request.
GET /aviation/chart/msl/analysis/sw-pac/06
12.2.4 API Response:
{
"version": "1.0",
"issue-time": "2025-09-08T22:36:37Z",
"path": "/aviation/api/aviation/chart/msl/analysis/sw-pac/06",
"response": [
{
"met:locator": "https://test-api.metservice.com/aviation/assets/chart/msl/sw-pac/anal/2025/09/08/06/202509080600_202509080600_202509080851.gif",
"met:analysis-time": "2025-09-08T06:00:00Z",
"met:product-name": "msl",
"met:domain": "aviation",
"met:issue-time": "2025-09-08T08:51:00Z",
"av:chart-type": "msl",
"met:prognosis-period": "000",
"av:msl-region": "sw-pac",
"met:valid-at": "2025-09-08T06:00:00Z",
"av:msl-type": "analysis",
"met:validity": "06"
}
]
}
12.3 Table of chart Region Codes
Region | Description |
---|---|
nz-au | New Zealand and Australia |
sw-pac | South West Pacific |
sth-ocean | Southern Ocean |